Index
| Overview |
|---|
| JSON Format |
| Schema |
| Client Biome Components |
| Client Biome Definition |
| Client Biome Description |
| Client Biome JSON File |
| minecraft:fog_appearance |
| minecraft:sky_color |
| minecraft:water_appearance |
Overview
Minecraft client_biome files define client-side settings for biomes in resource packs.This is the new preferred location for per-biome settings that used to be in biomes_client.json.(As of base game version 1.21.40, biomes_client.json is no longer loaded from built-in Vanilla resource packs. That file will still be loaded for other content regardless of version, and worlds using older base game versions will also still use it.)These files are not part of the 'Custom Biomes' experiment and do not cause biome definitions to exist on their own, but they can be used to customize client-side settings of custom biomes.Back to topJSON Format
Here is a sample client_biome file.Schema
Client Biome Components
Any components that this Client Biome uses| Name | Type | Required? | Description |
|---|---|---|---|
| minecraft:fog_appearance | Object | Optional | Set the fog settings used during rendering. Biomes without this component will have default fog settings. |
| minecraft:sky_color | Object | Optional | Set the sky color used during rendering. Biomes without this component will have default sky color behavior. |
| minecraft:water_appearance | Object | Optional | Set the water surface color used during rendering. Biomes without this component will have default water surface color behavior. |
Client Biome Definition
Contains a description and components to define a Client Biome.| Name | Type | Required? | Description |
|---|---|---|---|
| components | Object of type Client Biome Components | Required | Components for this Client Biome. |
| description | Object of type Client Biome Description | Required | Non-component settings, including the Client Biome name. |
Client Biome Description
Contains non-component settings for a Client Biome.| Name | Type | Required? | Description |
|---|---|---|---|
| identifier | String | Required | The name of the Client Biome, used by other features like the '/locate biome' command. Must match the name of a Biome defined by the game or a behavior pack. |
Client Biome JSON File
Contains a format version and a Client Biome definition| Name | Type | Required? | Description |
|---|---|---|---|
| format_version | String | Required | Version of the JSON schema used by this file |
| minecraft:client_biome | Object of type Client Biome Definition | Required | A single Client Biome definition, containing rendering or sound settings related to a Biome defined by the game or a behavior pack |
minecraft:fog_appearance
Set the fog settings used during rendering. Biomes without this component will have default fog settings.| Name | Type | Required? | Description |
|---|---|---|---|
| fog_identifier | String | Required | Identifier of fog definition to use |
minecraft:sky_color
Set the sky color used during rendering. Biomes without this component will have default sky color behavior.| Name | Type | Required? | Description |
|---|---|---|---|
| sky_color | Object of type Color255RGB | Required | RGB color of the sky |
minecraft:water_appearance
Set the water surface color used during rendering. Biomes without this component will have default water surface color behavior.| Name | Type | Required? | Description |
|---|---|---|---|
| surface_color | Object of type Color255RGB | Required | RGB color of the water surface |